home *** CD-ROM | disk | FTP | other *** search
/ PC Media 2 / PC MEDIA CD02.iso / share / udos / flash120 / flashled.doc < prev   
Encoding:
Text File  |  1992-03-04  |  9.6 KB  |  227 lines
  1.  
  2.       ========================================================
  3.                      FLASHLED.COM - FlashLED v1.20
  4.               "Disc Drive Activity at Your Finger Tips"
  5.  
  6.            (C)opyright 1991, 1992 - Seagate Technology, Inc.
  7.                    The first name in disc drives.
  8.                  written by R. Dimick and B. Rudock
  9.  
  10.                Seagate Tech Support BBS (408)438-8771
  11.       ========================================================
  12.  
  13. =====Intro==================
  14.  
  15. FlashLED is a very small TSR (Terminate and Stay Resident in memory)
  16. utility that uses the LED's (Light Emitting Diode) found on AT
  17. keyboards and, optionally, the system speaker to indicate disc drive
  18. activity.
  19.  
  20. Normally, the activity lights found on the front faceplates of the
  21. disc drive and/or the system chasis are more than adequate for
  22. displaying activity, however, many of today's smaller drives are
  23. mounted deep within the systems, obscuring any view of the drive's own
  24. LED (if it even has one). Also, many computer systems are of the
  25. "tower" type, taking them off the desk, which requires the user to
  26. look down at the floor for activity lights. In either case, FlashLED,
  27. can help by putting the activity light "at your finger tips."
  28.  
  29. =====Syntax=Summary========
  30.  
  31. The command line syntax of FlashLED is:
  32.  
  33.         FLASHLED [/options]
  34.  
  35. The default behavior, if no command line arguments are specified, is
  36. to display a "not installed" screen which offers the /? switch as a
  37. suggestion for command line options:
  38.  
  39.         ╔═════════════╡FlashLED v1.20╞══════════════╗
  40.         ║ ┌─┐┌─┐┌─┐┌─┐┌─┐┌─┐┌─┐┌─┐┌─┐┌─┐    ▄  ▄  ▄ ║
  41.         ║ └Q┘└W┘└E┘└R┘└T┘└Y┘└─┘└─┘└─┘└─┘            ║
  42.         ║  ┌─┐┌─┐┌─┐┌─┐┌─┐┌─┐┌─┐┌─┐┌─┐┌─┐  ┌─┐┌─┐┌─┐║
  43.         ║  └─┘└─┘└─┘└─┘└─┘└─┘└─┘└─┘└─┘└─┘  └─┘└─┘└─┘║
  44.         ║    ┌────────────────────────┐    ┌─┐┌─┐┌─┐║
  45.         ║    └────────────────────────┘    └1┘└2┘└3┘║
  46.         ╚═══════════════════════════════════════════╝
  47.          Seagate Disc Activity Keyboard LED Program
  48.           (C)opyright 1992 Seagate Technology, Inc.
  49.               written by R. Dimick & B. Rudock
  50.  
  51.         ┌──────────────────────┐
  52.         │FlashLED NOT INSTALLED│
  53.         ├──────────────────────┴────┐
  54.         │FlashLED /? for help screen│
  55.         ├───────────────────────────┴──────────────────────────────┐
  56.         │example: FlashLED /shp  (hard disc drives are monitored by│
  57.         │         the Scroll Lock LED and also by a speaker click) │
  58.         └──────────────────────────────────────────────────────────┘
  59.  
  60.         | The option switches are:
  61.         |
  62.         |    Select ONE of the keyboard LED options (or not) :
  63.         |       /N   Num Lock
  64.         |       /C   Caps Lock
  65.         |       /S   Scroll Lock
  66.         |       /K   Kill keyboard LED activity (FlashLED will not
  67.         |             indicate activity on the keyboard, so, hopefully,
  68.         |             you will be selecting the speaker option [/P])
  69.         |
  70.         |    Additionally, select ONE of the disc drive options:
  71.         |       /F   Floppy drives only
  72.         |       /H   Hard drives only
  73.         |       /B   Both floppy and hard disc drives
  74.         |
  75.         |    Optionally select one of these, if you like:
  76.         |       /P   sPeaker "click" with drive activity (low
  77.         |             frequency is READ, high frequency is WRITE)
  78.         |       /?   Display all of these options to the screen,
  79.         |             without loading the program. (overrides any
  80.         |             other command line arguments)
  81.  
  82. Multiple command line argument switches may be specified together or
  83. seperately. The following examples are functionally equivalent:
  84.  
  85.            FLASHLED /S /H /P
  86.            flashled /shp  (DOS nor FlashLED is case sensitive)
  87.        (this space ^ must be there)
  88.  
  89. =====Outline================
  90.  
  91. An brief outline of how FlashLED works is as follows:
  92.  
  93. A. FlashLED Disc Drive Activity from Keyboard LED program
  94.    1. Display program instructions and take user input of
  95.       configuration parameters
  96.       a) determine the current status of the keyboard LED's and save
  97.          that status then turn off all the LED's
  98.       b) wait for the user's selection of which keyboard LED should
  99.          indicate the activity (Num, Caps or Scroll Lock)
  100.       c) If it's not an LED that was ALREADY in use before the
  101.          program was started, then great, otherwise default to the
  102.          Scroll Lock LED.
  103.       d) wait for the user's selection of which drive devices (hard,
  104.          floppy or both) should reflect activity to the LED
  105.       e) wait for user's selection on activity "clicking" the speaker
  106.    2. terminate and stay resident
  107.    3. program "watches" for activity on DOS interrupt 13 (disk
  108.       services)
  109.       a) if "observed", then LED and/or speaker is turned on
  110.       b) when INT 13 concludes, LED is turned off after a few DOS
  111.          INT 1C timer ticks (18.2 ticks per second)
  112.    4. program removed from memory by a system reset or TSR
  113.       management utility
  114.  
  115. =====App=Notes==============
  116.  
  117.  
  118. Some Application Notes:
  119.  
  120.   1. The effect of the program on the performance of the system is
  121. negligible.
  122.  
  123.   2. When the speaker "click" sound option is activated, other
  124. programs which beep on errors will usually get their chance but then
  125. the beep frequency is lowered again to the level defined by FlashLED.
  126.  
  127.   3. The use of FlashLED on XT's is disallowed, since keyboard LED's
  128. are not defined in that host environment.
  129.  
  130.   4. In Windows (tm), the keyboard LED activity is suspended but the
  131. speaker click still works. When Windows is exited, the keyboard LED
  132. activity returns.
  133.  
  134.   5. Since FlashLED uses INT 1C (timer tick), some TSR screen clocks
  135. may not allow FlashLED to work properly. Try reversing the loading
  136. order of the TSR's.
  137.  
  138.   6. When disk caching software is in use, FlashLED may indicate
  139. activity when data is drawn from the cache (AKA a cache hit).
  140.  
  141.   7. There will be times when the keyboard activity LED doesn't seem
  142. to keep on pace with the activity of the drive. This is due to the
  143. fact that the bios keyboard services are given LOW priority; since the
  144. system figures that the user is probably the slowest component in the
  145. system, it doesn't come looking as often. As a result, FlashLED will
  146. tend to "even out" the rapid flicker of an busy drive's activity light
  147. and show a steady, even glow on the LED. If the speaker option [/p]
  148. has been selected, the "click" will easily keep up with the activity.
  149.  
  150.   8. As mentioned earlier, FlashLED is a tiny TSR (at 560 bytes). When
  151. a TSR is kept in memory, the total amount of memory space that it
  152. takes is the sum of itself and the DOS environment active at the time
  153. of the load.  Since many of us use a "PATH=" which is max'd out, a
  154. "PROMPT=" which is complex and a "SET=" for everything under the sun,
  155. our environment size gets pretty BIG!  To minimize the environment
  156. "impact" on the TSR, try getting the TSR's loaded and tucked in,
  157. first, then build up the environment variables.
  158.  
  159.   9. FlashLED will not see the activity of a network drive since
  160. different interrupts are being used.
  161.  
  162.  10. Some SCSI host adapters are bundled with device drivers which do
  163. not use INT 13, in which case the FlashLED program will not work.
  164. This may also be true for some partitioning software.
  165.  
  166.  11. If the program is started with /shp (scroll lock, hard drives
  167. only, speaker on), and then loaded again with /cf (caps lock, floppy
  168. only) the LED's will switch between scroll and caps, depending on hard
  169. or floppy drive access.
  170.  
  171. =====Rev=Hist===============
  172.  
  173. Revision History:
  174.  
  175.         10/91   v1.0   In-house release.
  176.         12/91   v1.1   Public release. Added speaker click, command
  177.                         line options.
  178.         03/92   v1.2   Upgrade: optimized code, lowered in-memory
  179.                         size, added color, dropped manual config now
  180.                         only command line.
  181.  
  182. =====Legal=Disclaimer=======
  183.  
  184.                           LICENSE AGREEMENT
  185.  
  186. Seagate provides the accompanying object code software ("Software")
  187. and nonexclusively licenses its use on the following terms and
  188. conditions. The Software is copyrighted by Seagate.  YOU ASSUME FULL
  189. RESPONSIBILITY FOR THE SELECTION OF THE SOFTWARE TO ACHIEVE YOUR
  190. INTENDED PURPOSES, FOR THE PROPER INSTALLATION AND USE.  SEAGATE DOES
  191. NOT WARRANT THAT THE SOFTWARE WILL MEET YOUR REQUIREMENTS, THAT THE
  192. SOFTWARE IS FIT FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE
  193. SOFTWARE WILL BE ERROR FREE.  SEAGATE EXPRESSLY DISCLAIMS ALL
  194. WARRANTIES, WHETHER ORAL OR WRITTEN, EXPRESSED OR IMPLIED, INCLUDING
  195. WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A
  196. PARTICULAR PURPOSE.  IN NO EVENT WILL SEAGATE BE LIABLE TO YOU, YOUR
  197. CUSTOMERS OR OTHER USERS FOR ANY INDIRECT, INCIDENTAL, CONSEQUENTIAL,
  198. SPECIAL OR EXEMPLARY DAMAGES ARISING OUT OF OR IN CONNECTION WITH THE
  199. USE OR INABILITY TO USE THE SOFTWARE.
  200.  
  201. End of License agreement.
  202.  
  203. =====Other==================
  204.  
  205. Available on the Seagate Tech Support BBS (408)438-8771:
  206.  
  207. Specifications and jumper drawings for all Seagate Disc Drives and
  208. Controllers.
  209.  
  210. Reprints of Installation Guides.
  211.  
  212. Troubleshooting essays.
  213.  
  214. FINDTYPE - Utility which displays bios drive type table and matches a
  215. Seagate model to the best drive type.  Also prints complete
  216. specifications lists and much more!
  217.  
  218. FINDINIT - Utility for Seagate controllers and host adapters that have
  219. onboard bios. Queries the system to determine bios memory address and
  220. initiates low-level format.
  221.  
  222. DESK REFERENCE - Hypertext data system for all Seagate products,
  223. troubleshooting, other OEM phone numbers and much, much more. A must
  224. for dealers who do a fair amount of support for Seagate products.
  225.  
  226. -=EOF: FLASHLED.DOC=-
  227.